IRIX Base Documentation 2002 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / SgArc.z / SgArc

Wrap

Text File | 2002-10-03 | 14.7 KB | 331 lines

SSSSggggAAAArrrrcccc((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV SSSSggggAAAArrrrcccc((((3333XXXX)))) NNNNAAAAMMMMEEEE SSSSggggAAAArrrrcccc - Arc widget designed for use with SgGraph. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Xm.h> #include <Sgm/Graph.h> #include <Sgm/Arc.h> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents the version of Sgm that accompanies Motif 1.2. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The SgArc widget is a special widget that resembles a gadget in that it has no window of its own. It draws in the window of the SgGraph widget, with cooperation of the Graph widget. The Arc widget can only be used with the Graph widget. An arc may be undirected, directed, or bidirected. CCCCLLLLAAAASSSSSSSSEEEESSSS The Arc widget inherits behavior from the Core widget class. Its class pointer is ssssggggAAAArrrrccccWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss Its class name is SSSSggggAAAArrrrcccc. AAAARRRRCCCC RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The Arc widget defines a set of resource types used by the programmer to specify the data for the arc. These resources are used to set attributes for arcs when specifying node parent-child relationships. The following table contains the set of resources defined by the Arc widget. To specify any of these resources within the .Xdefaults file, simply drop the XmN prefix from the resource name. SSSSggggAAAArrrrcccc RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ___________________________________________________________________________ XmNto XmCTo XmRPointer NULL CSG XmNfrom XmCFrom XmRPointer NULL CSG XmNtoPosition XmCPosition XmRShort 50 CSG XmNfromPosition XmCPosition XmRShort 50 CSG XmNfromSide XmCSide XmRShort XmRIGHT CSG XmNtoSide XmCSide XmRShort XmLEFT CSG XmNarcDirection XmCDirection XmRArcDirection XmDIRECTED CSG XmNforeground XmCForeground Pixel "Black" CSG XmNhighlight XmCHighlight Boolean "False" CSG XmNfontList XmCFontList FontList "Fixed " XmNlabelString XmCXmString XmString dynamic CSG XmNmapLabel XmCBoolean Boolean "FALSE" CSG XmNarcWidth XmCArcWidth int 0 CSG Page 1 (printed 10/3/02) SSSSggggAAAArrrrcccc((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV SSSSggggAAAArrrrcccc((((3333XXXX)))) XmNstyle XmCStyle int LineSolid CSG XmNcapStyle XmCapStyle int CapButt CSG XmNdashes XmCDashes int 4 CSG XmNdashOffset XmCDashOffset int 0 CSG XmNarmCallback XmCCallback Pointer NULL C XmNdisarmCallback XmCCallback Pointer NULL C XmNactivateCallback XmCCallback Pointer NULL C XmNatribute XmCAttribute Atom NULL C XmNuserData XmCUserData Pointer NULL CSG XXXXmmmmNNNNttttoooo The widget this arc points to. XXXXmmmmNNNNffffrrrroooommmm The widget this arc points from. XXXXmmmmNNNNaaaarrrrccccWWWWiiiiddddtttthhhh The width, in pixels, of the line drawn for the arc. Zero means to draw using the server's fastest algorithm with a line width of one pixel. XXXXmmmmNNNNssssttttyyyylllleeee Specifies whether the line is solid in foreground, dashed in foreground, or alternating foreground and background. Possible values are LineSolid (the default), LineOnOffDash, or LineDoubleDash. XXXXmmmmNNNNccccaaaappppSSSSttttyyyylllleeee Controls the appearance of the ends of a line. This characteristic affects the ends of lines drawn in dashes, and both ends of each dash in some cases. Possible values are CapNotLast, CapButt (the default), CapRound, and CapProjecting. XXXXmmmmNNNNddddaaaasssshhhheeeessss Specifies the length of the dashes for custom-designed dashed lines. The default (4) is equivalent to the list {4,4} (a dash of 4 pixels, followed by a space of 4 pixels). XXXXmmmmNNNNddddaaaasssshhhhOOOOffffffffsssseeeetttt Specifies the starting point of the dash pattern, from the parent node, for dashed lines. XXXXmmmmNNNNllllaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg This resource specifies a compound string which will be displayed with the arc, if the XmNmapLabel resource is true. If no labelString is given, the widget defaults to using the widget name as the label. Page 2 (printed 10/3/02) SSSSggggAAAArrrrcccc((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV SSSSggggAAAArrrrcccc((((3333XXXX)))) XXXXmmmmNNNNmmmmaaaappppLLLLaaaabbbbeeeellll If true (the default), the label, if any, will be displayed. XXXXmmmmNNNNaaaarrrrccccDDDDiiiirrrreeeeccccttttiiiioooonnnn If XmDIRECTED, will display an arrow head on the child end, if XmBIDIRECTED will display an arrow head on both ends, otherwise no arrow head is displayed. XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd Color in which the arc and its label will be drawn. XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt Font used to write the label with when XmNmapLabel is true. XXXXmmmmNNNNaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmNNNNddddiiiissssaaaarrrrmmmmCCCCaaaallllllllbbbbaaaacccckkkk XXXXmmmmNNNNaaaaccccttttiiiivvvvaaaatttteeeeCCCCaaaallllllllbbbbaaaacccckkkk These callbacks are equivalent to the pushbutton callbacks of the same name. XXXXmmmmNNNNffffrrrroooommmmSSSSiiiiddddeeee If the parent graph widget's XmNdrawMode resource is set to XmPOSITION_PROPORTIONAL, this resource determines the side of the "from" node to which this arc is attached. Possible values are XmLEFT, XmRIGHT, XmTOP, and XmBOTTOM. XXXXmmmmNNNNffffrrrroooommmmPPPPoooossssiiiittttiiiioooonnnn If the parent graph widget's XmNdrawMode resource is set to XmPOSITION_PROPORTIONAL, this resource determines the position of the arc at the point it leaves the "from" node. Values are given in percentages of the relevant node size, and can range from 0-100. XXXXmmmmNNNNttttooooSSSSiiiiddddeeee If the parent graph widget's XmNdrawMode resource is set to XmPOSITION_PROPORTIONAL, this resource determines the side of the "to" node to which this arc is attached. Possible values are XmLEFT, XmRIGHT, XmTOP, and XmBOTTOM. XXXXmmmmNNNNttttooooPPPPoooossssiiiittttiiiioooonnnn If the parent graph widget's XmNdrawMode resource is set to XmPOSITION_PROPORTIONAL, this resource determines the position of the arc at the point it leaves the "to" node. Values are given in percentages of the relevant node size, and can range from 0-100. Page 3 (printed 10/3/02) SSSSggggAAAArrrrcccc((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV SSSSggggAAAArrrrcccc((((3333XXXX)))) IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The following resources are inherited from the named superclasses: CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ____________________________________________________________________________________________ XmNaccelerators XmCAccelerators XtTranslations NULL CSG XmNancestorSensitive XmCSensitive Boolean True G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNcolormap XmCColormap Colormap XtCopyFromParent CG XmNdepth XmCDepth int XtCopyFromParent CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Pointer XtCopyScreen CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations NULL CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn See SgGraph(3x) UUUUTTTTIIIILLLLIIIITTTTYYYY FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS Widget SSSSggggCCCCrrrreeeeaaaatttteeeeAAAArrrrcccc (_g_r_a_p_h, _n_a_m_e, _a_r_g_s, _n__a_r_g_s) XwGraphWidget _g_r_a_p_h; char _n_a_m_e; ArgList _a_r_g_s; int _n__a_r_g_s; A convenience function that creates an SgArc widget named _n_a_m_e whose parent is _g_r_a_p_h. Widget SSSSggggCCCCrrrreeeeaaaatttteeeeAAAAttttttttaaaacccchhhheeeeddddAAAArrrrcccc (_g_r_a_p_h, _n_a_m_e, _f_r_o_m, _t_o, _a_r_g_s, _n__a_r_g_s) XwGraphWidget _g_r_a_p_h; char _n_a_m_e; Widget _f_r_o_m; Widget _t_o; ArgList _a_r_g_s; int _n__a_r_g_s; SSSSggggCCCCrrrreeeeaaaatttteeeeAAAAttttttttaaaacccchhhheeeeddddAAAArrrrcccc creates an arc from _f_r_o_m to _t_o with arguments _a_r_g_s, name _n_a_m_e, and returns its widget ID. _f_r_o_m and _t_o must be node widgets in _g_r_a_p_h. Returns NULL if not successful. Widget SSSSggggAAAArrrrccccGGGGeeeettttPPPPoooossss (_a_r_c, _x_1, _y_1, _x_2, _y_2) SgArcWidget _a_r_c; Position *_x_1, *_y_1, *_x_2, *_y_2; Page 4 (printed 10/3/02) SSSSggggAAAArrrrcccc((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV SSSSggggAAAArrrrcccc((((3333XXXX)))) SSSSggggAAAArrrrccccGGGGeeeettttPPPPoooossss returns the coordinates of the endpoints of the given arc. RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))), SSSSggggGGGGrrrriiiidddd((((3333XXXX)))), Page 5 (printed 10/3/02)